home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / sound / cdrdemo.zip / CDREVIEW.DOC < prev    next >
Text File  |  1996-07-01  |  7KB  |  178 lines
  1.  
  2. :CD REVIEW
  3. :An Audio CD Catalog and Review Program for TDBS 1.2
  4. :A STAINLESS STEEL SOFTWARE Production
  5. :Written by Mark L. Chambers
  6. :version 1.1
  7.  
  8.  
  9. :Description:
  10. :::::::::::::
  11.  
  12. CD REVIEW is a catalog database for audio CDs that allows your users to add 
  13. their own reviews!  The program is colorful, easy-to-use and completely 
  14. self-maintaining, so it will require little attention on your part (besides
  15. an occasional database pack).
  16.  
  17. Here's a partial listing of CD REVIEW features:
  18.  
  19. o  Fast index search routine.  Your users can search on any one of 6 keys:
  20.    the CD title, artist, release date, musical style, reviewer's rating and
  21.    reviewer's name.  The last two keys are certain to generate messages as
  22.    your reviewers argue and discuss each other's ratings and reviews!
  23.  
  24. o  Comprehensive data entry.  Besides the search keys, each CD entry can
  25.    include the total music time in minutes, the company label and a
  26.    comment of up to three lines.
  27.  
  28. o  Display and download functions.  Your users will be able to view reviews
  29.    online, or they can download a formatted text listing of every entry in
  30.    the database!
  31.  
  32. o  Edit and delete functions.  Reviewers can edit their entries at a later
  33.    date, or delete entries completely if they wish.  The sysop can edit or
  34.    delete any entry.
  35.  
  36. o  NEW with version 1.1:  Custom ANSI header!  You can now replace the
  37.    default CD REVIEW ANSI screen with your own customized ANSI header!
  38.  
  39. o  NEW with version 1.1:  Free review database!  If you'd like to start
  40.    with entries in CD REVIEW instead of an empty database, a sample set of
  41.    reviews is included!  All reviews in this database are attributed to
  42.    "Anonymous", so your users won't be scrambling to find the reviewer!
  43.  
  44.    Sysop Commands:
  45.  
  46. o  Automatic reindexing.  If your database or index is corrupted, CD REVIEW
  47.    can rebuild the indexes for you.
  48.  
  49. o  Pack deleted records.  Remove deleted entries and rebuild the indexes.
  50.  
  51. o  Data to disk.  Create a complete text listing of every entry in the
  52.    database for display as a bulletin or a download file.
  53.  
  54.  
  55. :Installation:
  56. ::::::::::::::
  57.  
  58. 1. Create a directory for CD REVIEW.  I suggest you place it below your \TBBS
  59.    directory.  As an example, if your \TBBS directory is located on Drive C:
  60.  
  61.          MKDIR C:\TBBS\CDREVIEW
  62.  
  63. 2. Copy the files from your distribution archive into this new directory.
  64.  
  65. 3. Add an entry to your .SDL file to run CD REVIEW.  For example:
  66.  
  67.          KEY=F TYPE=200 Opt Data=c:\tbbs\cdreview\cdreview /Q
  68.          ANSI=X
  69.  
  70. OPTIONAL:  If you're a registered owner of CD REVIEW, you can also display
  71. your own custom ANSI header file instead of the default header and
  72. registration information... this makes your installation as seamless as
  73. possible!  To enable this function:
  74.  
  75. a. Use an ANSI paint program like TheDraw to create your ANSI header.  Note
  76.    that the header must be no longer than 12 lines long, and it MUST begin
  77.    with a clear screen code to display correctly!  The file should be saved
  78.    with the name CUSTOM.ANS, and it must be located in the same directory as
  79.    CD REVIEW.  (As an example, the file SAMPLE.ANS is included with this
  80.    archive.)
  81.  
  82. b. Add the switch /CUSTOM onto the end of your .SDL entry.  For example:
  83.  
  84.          KEY=F TYPE=200 Opt Data=c:\tbbs\cdreview\cdreview /Q && /CUSTOM
  85.  
  86.    Note that the two ampersands (&&) are required - they indicate a switch
  87.    follows the /Q. 
  88.  
  89. 4. Recompile your .SDL file to make the new menu entry available.
  90.  
  91. This completes the installation of CD REVIEW!  The program will create its
  92. index files and an empty database the first time you run it.  Temporary files
  93. are automatically deleted after they're used.
  94.  
  95. OPTIONAL:  If you're a registered owner of CD REVIEW and you'd like to use
  96. the database with existing reviews as a starting point, simply copy the file
  97. SAMPLE.ANS over the empty CDREVIEW.DBF created when the demo runs for the
  98. first time!  Remember, the unregistered demonstration program erases all but
  99. the first six reviews, so you'll want to do this only after you've purchased
  100. the program and installed the key!
  101.  
  102.  
  103. :Registration:
  104. ::::::::::::::
  105.  
  106. The unregistered demonstration version of CD REVIEW will allow only six
  107. records.  Nothing else is crippled within the demonstration version.
  108.  
  109. You may purchase CD REVIEW from STAINLESS STEEL SOFTWARE with a check or
  110. money order.  For complete information, see the file ORDERFRM.DOC.
  111.  
  112.  
  113. :Sysop Notes:
  114. :::::::::::::
  115.  
  116. 1. If the CD REVIEW search and display functions don't seem to work properly
  117.    or return errors, your index files may be corrupted - to regenerate these
  118.    index files, change to your CDREVIEW directory and type:
  119.  
  120.          DEL *.NDX
  121.    
  122.    to delete all of the indexes.  CD REVIEW will automatically reindex the 
  123.    database the next time it runs.
  124.  
  125. 2. If you use the Data to Disk sysop command, the review listing will appear
  126.    in your CDREVIEW directory as CDLIST00.TXT.
  127.  
  128. 3. The Delete and Edit functions use the logon name as a security check to
  129.    prevent a user from modifying or deleting reviews left by another user.
  130.    Naturally, if your TBBS configuration allows users to have the same name
  131.    (and differentiates between them only by their locations), this will not
  132.    guarantee security.
  133.  
  134. 4. CD REVIEW authorizes the Sysop Menu (and the right to delete and edit any
  135.    review) only to security level 255.
  136.  
  137. 5. CD REVIEW requires TBBS 2.2 and TDBS 1.2.  It also requires ANSI.
  138.  
  139.  
  140. :Legalities and Support:
  141. ::::::::::::::::::::::::
  142.  
  143. CD REVIEW is copyright (c) 1993,1996 by Mark L. Chambers.  All rights are 
  144. reserved.
  145.  
  146. This program is distributed "as is", without any explicit or implied 
  147. warranty. Registered copies of CD REVIEW are intended for use by the original 
  148. purchaser only, and use is limited to a single TBBS installation.  Copying, 
  149. duplication and reverse-engineering of this software are specifically 
  150. prohibited.  The author is not responsible for any damage or loss related 
  151. to this product.  Your use of this program constitutes your agreement to this
  152. disclaimer and your release of the author from any form of liability or
  153. litigation.
  154.  
  155. The author will diagnose and correct program errors as they're discovered. To 
  156. submit bug reports, questions and requests for additional features, see the
  157. technical support information included in ORDERFRM.DOC.
  158.  
  159.  
  160. :Credits:
  161. :::::::::
  162.  
  163. First, my sincere thanks are due to Mr. John Schachat for his advice and
  164. support!  His patience and code suggestions were equally valuable to me.
  165.  
  166. Coding thanks are also due to Mr. Bryan Chilcutt, who supplied advice in
  167. the development of the registration logic.
  168.  
  169. TBBS and TDBS are manufactured by eSoft, Inc.
  170.  
  171.  
  172. :A Final Word:
  173. ::::::::::::::
  174.  
  175. Enjoy!
  176.  
  177.  
  178.